docs: rotki premium

.vitepress/config.mts

@@ -83,6 +83,19 @@ export default defineConfig({
           { text: 'Using rotki from mobile', link: '/usage-guides/using-rotki-from-mobile' },
         ],
       },
+      {
+        text: 'Premium',
+        items: [
+          { text: 'Overview', link: '/premium/' },
+          { text: 'Plans & Pricing', link: '/premium/plans-and-pricing' },
+          { text: 'Payment Process', link: '/premium/payment' },
+          { text: 'Subscription Management', link: '/premium/subscription' },
+          { text: 'API Keys & Secrets', link: '/premium/api-keys' },
+          { text: 'Payment Methods', link: '/premium/payment-methods' },
+          { text: 'Device Management', link: '/premium/devices' },
+          { text: 'Referral Program', link: '/premium/referrals' },
+        ],
+      },
       {
         text: 'Frequently Asked Questions',
         items: [

faq.md

@@ -36,11 +36,35 @@ If you like rotki, you can support us with a premium subscription and you not on
 
 Short answer: **No**
 
-At rotki, we believe in building sustainable, long-term software that delivers continuous value to our users. Offering a lifetime subscription may sound appealing on the surface, but in reality, it’s a model that often leads to the collapse of the very products it’s meant to support. Many companies that adopt this approach either shut down within a few years or abandon the product once the initial influx of revenue dries up.
+At rotki, we believe in building sustainable, long-term software that delivers continuous value to our users. Offering a lifetime subscription may sound appealing on the surface, but in reality, it's a model that often leads to the collapse of the very products it's meant to support. Many companies that adopt this approach either shut down within a few years or abandon the product once the initial influx of revenue dries up.
 
 rotki has been around since 2017, delivering continuous, original improvements every month. Offering a lifetime subscription would require us to put a fixed price on the indefinite future work of our entire team, which is simply not realistic or fair. Building and maintaining a privacy-respecting, local-first, open-source financial tool involves real and growing costs.
 
-It’s also worth noting that our current pricing model hasn’t changed since 2017. We’re currently re-evaluating it to better reflect the actual cost of development, support, and infrastructure, especially in light of inflation and the expanded scope of what rotki offers today. Our goal is to keep rotki accessible while ensuring its long-term health and independence.
+It's also worth noting that our current pricing model hasn't changed since 2017. We're currently re-evaluating it to better reflect the actual cost of development, support, and infrastructure, especially in light of inflation and the expanded scope of what rotki offers today. Our goal is to keep rotki accessible while ensuring its long-term health and independence.
+
+### How do I manage my premium subscription?
+
+You can manage your premium subscription, payment methods, devices, and referrals through your rotki.com account. See the [Premium documentation](/premium/) for detailed guides on:
+
+- [Managing your subscription](/premium/subscription) - View payment history, cancel subscription
+- [Payment methods](/premium/payment-methods) - Add, remove, or change cards
+- [Device management](/premium/devices) - Manage device limits
+- [Referral program](/premium/referrals) - Create and share referral codes
+
+### How do device limits work?
+
+Each premium tier has a device limit. You can manage your devices from the app (**Settings → Account → Premium Devices**) or from the [website](https://rotki.com/home/devices).
+
+If you exceed your device limit, remove unused devices to continue using rotki. See [Device Management](/premium/devices) for more information.
+
+### Need help with premium?
+
+If you have questions about premium subscriptions, payment, billing, or account management:
+
+- Check the answers above in this FAQ section
+- Visit the [Premium documentation](/premium/) for detailed guides
+- Contact support at [[email protected]](mailto:[email protected])
+- Join our [Discord community](https://discord.rotki.com)
 
 ## Questions on Roadmap and Features
 

premium/api-keys.md

@@ -0,0 +1,144 @@
+# API Credentials
+
+rotki premium uses API credentials to connect your subscription to the rotki application. This guide explains how to create, manage, and secure your API credentials.
+
+## What are rotki Premium API Credentials?
+
+The API Key and Secret are authentication credentials that:
+
+- Link your rotki app to your premium subscription
+- Enable premium features in the application
+- Allow cloud backup and sync across devices
+- Identify your account for device limit management
+
+## Creating API Credentials
+
+After purchasing a subscription, you need to manually generate your API credentials:
+
+1. Go to your [subscription page](https://rotki.com/home/subscription)
+2. Navigate to the **API Credentials** section
+3. Click the **Create** button
+4. Your credentials will be generated and displayed:
+   - **API Key** - Your public identifier
+   - **API Secret** - Your private authentication token
+5. You can view both credentials anytime from your subscription page
+
+::: info Manual Generation Required
+API Credentials are not automatically created after payment. You must click the button to generate them for the first time.
+:::
+
+## Using API Credentials in the App
+
+After creating your API credentials, add them to rotki:
+
+1. Open the rotki application
+2. Navigate to **API Keys** → **rotki Premium** in the sidebar
+3. Enter your **API Key** and **API Secret**
+4. Click **Setup**
+
+![Set up rotki premium API key/secret pair in an existing account](/images/rotki_premium_set.png)
+
+## Managing API Credentials
+
+### Viewing Your Credentials
+
+From your [subscription page](https://rotki.com/home/subscription):
+
+- Both your API Key and Secret are always visible
+- You can copy them anytime you need
+- You can see when the key was created
+
+### Regenerating Credentials
+
+If you need to create new credentials:
+
+1. Go to your [subscription page](https://rotki.com/home/subscription)
+2. Click the **Regenerate** button
+3. Your new API Key and Secret will be generated and displayed
+4. Update credentials on all your devices
+
+::: tip When to Regenerate
+
+- If you suspect your credentials have been compromised
+- If you want to revoke access from all devices
+  :::
+
+## Security Best Practices
+
+### Protecting Your Credentials
+
+::: danger Keep Your Secret Safe
+
+- **Never** share your API Secret with anyone
+- **Never** post it in public forums or Discord
+- **Never** commit it to version control (Git, etc.)
+- **Never** send it via unencrypted channels
+  :::
+
+### Storage Recommendations
+
+Store your API credentials securely:
+
+- Use a password manager (1Password, Bitwarden, KeePass, etc.)
+- Keep backups in a secure location
+- Don't save them in plain text files
+- Don't email them to yourself
+
+### If Credentials are Compromised
+
+If you believe your API credentials have been exposed:
+
+1. **Immediately** regenerate your API credentials from the [subscription page](https://rotki.com/home/subscription) by clicking **Regenerate**
+2. Update all your legitimate devices with the new credentials
+3. Monitor your account for unusual activity
+
+## API Keys and Device Limits
+
+Each premium tier has a device limit. Each rotki app account where you add your
+API credentials is registered as a new device and counts toward your device limit.
+
+For more information about managing your devices, device limits, and what to do
+when you exceed your device limit, see the [Device Management](/premium/devices) documentation.
+
+## Troubleshooting
+
+### Invalid API Key/Secret Error
+
+If you see authentication errors:
+
+1. Verify you copied the credentials correctly (no extra spaces)
+2. Ensure your subscription is active (check [subscription page](https://rotki.com/home/subscription))
+3. Verify your API credentials are still visible on the subscription page
+4. Try regenerating your credentials
+
+### Can't See My API Key/Secret
+
+If you can't see your credentials on the subscription page:
+
+1. Verify you're logged in to the correct rotki.com account
+2. Ensure you've already generated API credentials (if not, click the generate button)
+3. Refresh the page
+4. Contact [[email protected]](mailto:[email protected]) if the issue persists
+
+### Premium Features Not Working
+
+If premium features aren't activating:
+
+1. Verify API credentials are entered correctly in the app
+2. Check your subscription is active and not expired
+3. Ensure you haven't exceeded your device limit
+4. Try removing and re-adding the credentials
+5. Check the app logs for specific errors
+
+When premium is successfully activated in the app you should see a `rotki Premium is active` banner in the rotki Premium view.
+
+![Active rotki premium](/images/active_premium.png)
+
+### Multiple Devices Not Syncing
+
+If sync isn't working across devices:
+
+1. Verify all devices use the same API credentials
+2. Ensure "Allow data sync with rotki Server" is enabled (see [Sync Guide](/usage-guides/#sync-data-with-rotki-server))
+3. Check you haven't exceeded device limits
+4. Manually trigger sync from the toolbar