Skip to content

Commit ce3ff00

Browse files
JanCizmarclaude
andauthored
Update self-hosting and licensing docs for new pricing model (#1088)
## Summary - **Getting started page**: Added a prominent note recommending Tolgee Cloud with a list of self-hosting trade-offs (maintenance, infra cost, setup, support limitations). Replaced old "Pricing" section with "Free vs Licensed Self-Hosting" overview. - **Licensing page**: Updated to reflect that self-hosted plans are now custom (contact sales@tolgee.io) rather than self-serve. Kept the existing subscribe/apply license key/cancel flows and screenshots intact. ## Test plan - [ ] Verify the getting started page renders the `:::tip` admonition correctly - [ ] Verify all links work (Tolgee Cloud sign-up, self-hosting pricing page, licensing page, mailto) - [ ] Verify screenshots still display correctly on the licensing page 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
1 parent 838b803 commit ce3ff00

2 files changed

Lines changed: 118 additions & 87 deletions

File tree

Lines changed: 53 additions & 32 deletions
Original file line numberDiff line numberDiff line change
@@ -1,33 +1,54 @@
1-
---
2-
id: getting_started
3-
title: Getting Started
4-
sidebar_label: Getting Started
1+
---
2+
id: getting_started
3+
title: Getting Started
4+
sidebar_label: Getting Started
55
image: /img/og-images/self-hosting.png
6-
---
7-
8-
It is great to have you here! This guide will help you get started with the self-hosted version of Tolgee!
9-
10-
## Installation
11-
First, you need to decide whether you want to run Tolgee with Docker or Java.
12-
13-
The easiest way to run Tolgee is with **Docker**. You can find more information about Docker installation [here](running_with_docker).
14-
15-
If you want to run Tolgee with **Java**, you can find more information about Java installation [here](running_with_java).
16-
17-
## System Requirements
18-
Depending on your usage, required system resource to run Tolgee may vary. Minimum system specification for running Tolgee is:
19-
20-
- 2 CPU cores
21-
- 4 GB RAM
22-
23-
Current recommended system specification for running Tolgee is:
24-
25-
- 4 CPU cores
26-
- 16 GB RAM
27-
- 20 GB free disk storage space
28-
29-
## Configuration
30-
After you have installed Tolgee, you need to configure it. You can view the configuration guide for the self-hosted version [here](configuration).
31-
32-
## Pricing
33-
Pricing for the self-hosted version is different from the cloud version. You can find the pricing [here](https://tolgee.io/pricing/self-hosted).
6+
---
7+
8+
This guide will help you get started with the self-hosted version of Tolgee.
9+
10+
:::tip We recommend Tolgee Cloud
11+
For most teams, [**Tolgee Cloud**](https://app.tolgee.io/sign_up) is the better option. It requires no maintenance, comes with full support, and you always get the latest features automatically.
12+
13+
Self-hosting comes with real trade-offs:
14+
15+
- **Maintenance overhead** — you are responsible for keeping the server running, applying updates, managing backups, and handling incidents.
16+
- **Infrastructure cost** — you pay for your own servers, storage, and networking on top of any Tolgee license.
17+
- **Setup and configuration** — you need to deploy Tolgee, configure it, and integrate it with your environment yourself.
18+
- **Harder to support** — when something goes wrong, our team cannot access your servers, so diagnosing issues takes longer.
19+
20+
If you don't have a specific requirement to keep data on your own servers, we recommend starting with [Tolgee Cloud](https://app.tolgee.io/sign_up).
21+
22+
Learn more about all self-hosting options on the [self-hosting page](https://tolgee.io/pricing/self-hosted).
23+
:::
24+
25+
## Installation
26+
27+
First, you need to decide whether you want to run Tolgee with Docker or Java.
28+
29+
The easiest way to run Tolgee is with **Docker**. You can find more information about Docker installation [here](running_with_docker).
30+
31+
If you want to run Tolgee with **Java**, you can find more information about Java installation [here](running_with_java).
32+
33+
## System Requirements
34+
35+
Depending on your usage, required system resources to run Tolgee may vary. Minimum system specification for running Tolgee is:
36+
37+
- 2 CPU cores
38+
- 4 GB RAM
39+
40+
Current recommended system specification for running Tolgee is:
41+
42+
- 4 CPU cores
43+
- 16 GB RAM
44+
- 20 GB free disk storage space
45+
46+
## Configuration
47+
48+
After you have installed Tolgee, you need to configure it. You can view the configuration guide for the self-hosted version [here](configuration).
49+
50+
## Free vs Licensed Self-Hosting
51+
52+
The free self-hosted version includes core localization features, up to 10 seats, and machine translation via your own API keys. Advanced features like SSO or granular permissions require a [licensed plan](licensing).
53+
54+
For more details, see the [self-hosting page](https://tolgee.io/pricing/self-hosted).
Lines changed: 65 additions & 55 deletions
Original file line numberDiff line numberDiff line change
@@ -1,55 +1,65 @@
1-
---
2-
id: licensing
3-
title: Licensing
4-
sidebar_label: Licensing
5-
image: /img/og-images/self-hosting.png
6-
---
7-
8-
import { ScreenshotWrapper } from '../shared/_ScreenshotWrapper';
9-
10-
If you use the self-hosted version of Tolgee and want to use the advanced features, you need to subscribe to [one of the paid plans](https://tolgee.io/pricing/self-hosted).
11-
You can subscribe to a paid plan directly on Tolgee Cloud.
12-
13-
## Subscribing to a plan
14-
15-
First, open Tolgee Cloud and go to the [Subscription page of your organization](https://app.tolgee.io/billing-self-hosted).
16-
17-
Then choose the plan you want to subscribe to. **You can switch to the monthly or yearly billing** cycle (there is a discount for yearly billing). Please note that the **usage is billed monthly**.
18-
19-
After that, click on the "Subscribe" button.
20-
21-
<ScreenshotWrapper
22-
src="/img/docs/platform/subscriptions-selfhosted.webp"
23-
alt="Subscription page"
24-
/>
25-
26-
You will be redirected to the payment gateway. Fill in the form and pay for the subscription.
27-
28-
After the payment is processed, you will be **redirected to the Tolgee platform**, and the license key will be displayed. You need to **copy the license key**, as you will need it in the next step.
29-
30-
![License key](/img/docs/platform/subscription_license_key.webp)
31-
32-
Then you can close this page and open the **Server administration on your self-hosted instance**.
33-
34-
Once you navigate to the "License" tab, **paste the license key** into the input field and click the "Apply license key" button.
35-
36-
![Self-hosted instance – apply license key](/img/docs/platform/subscription_self-hosted_license_key.webp)
37-
38-
You will be **prompted to confirm the license key** application. Then, click on the "Confirm" button.
39-
40-
![Self-hosted instance – confirm license key](/img/docs/platform/subscription_self-hosted_license_key_confirmation.webp)
41-
42-
After that, the license key will be applied, and the **plan will be activated**. You can now use the advanced features of Tolgee!
43-
44-
![Self-hosted instance – activated plan](/img/docs/platform/subscription_self-hosted_plan.webp)
45-
46-
## Cancelling a plan
47-
48-
If you want to cancel your paid plan, you can do so on the Tolgee platform.
49-
Go to the [Subscription page of your organization](https://app.tolgee.io/billing-self-hosted) and click on the "Cancel" button **on the plan you want to cancel**.
50-
51-
![Cancel subscription](/img/docs/platform/subscription_self-hosted_cancel.webp)
52-
53-
You will be **prompted to confirm the cancellation**. Next, click on the "Confirm" button. After that, the plan will be canceled, and the **change will be applied to your self-hosted instance**.
54-
55-
![Confirm cancellation](/img/docs/platform/subscription_self-hosted_cancel_confirm.webp)
1+
---
2+
id: licensing
3+
title: Licensing
4+
sidebar_label: Licensing
5+
image: /img/og-images/self-hosting.png
6+
---
7+
8+
import { ScreenshotWrapper } from '../shared/_ScreenshotWrapper';
9+
10+
If you use the self-hosted version of Tolgee and want to use the advanced features, you need a licensed plan.
11+
Licensed self-hosted plans are tailored to your needs and require contacting us first. For more details, see the [self-hosting pricing page](https://tolgee.io/pricing/self-hosted).
12+
13+
## Getting a licensed plan
14+
15+
[Contact us](mailto:sales@tolgee.io) to discuss your needs. We will set up a custom plan for you in Tolgee Cloud. Once the plan is ready, you can subscribe to it and get your license key.
16+
17+
:::note
18+
Cloud subscriptions and self-hosted licenses are separate. A cloud plan does not apply to your self-hosted instance.
19+
:::
20+
21+
## Subscribing to a plan
22+
23+
Once we have set up a custom plan for you, open Tolgee Cloud and go to the [Subscription page of your organization](https://app.tolgee.io/billing-self-hosted).
24+
25+
Then choose the plan you want to subscribe to. **You can switch to the monthly or yearly billing** cycle (there is a discount for yearly billing). Please note that the **usage is billed monthly**.
26+
27+
After that, click on the "Subscribe" button.
28+
29+
<ScreenshotWrapper
30+
src="/img/docs/platform/subscriptions-selfhosted.webp"
31+
alt="Subscription page"
32+
/>
33+
34+
You will be redirected to the payment gateway. Fill in the form and pay for the subscription.
35+
36+
After the payment is processed, you will be **redirected to the Tolgee platform**, and the license key will be displayed. You need to **copy the license key**, as you will need it in the next step.
37+
38+
![License key](/img/docs/platform/subscription_license_key.webp)
39+
40+
## Applying the license key
41+
42+
Open the **Server administration on your self-hosted instance**.
43+
44+
Once you navigate to the "License" tab, **paste the license key** into the input field and click the "Apply license key" button.
45+
46+
![Self-hosted instance – apply license key](/img/docs/platform/subscription_self-hosted_license_key.webp)
47+
48+
You will be **prompted to confirm the license key** application. Then, click on the "Confirm" button.
49+
50+
![Self-hosted instance – confirm license key](/img/docs/platform/subscription_self-hosted_license_key_confirmation.webp)
51+
52+
After that, the license key will be applied, and the **plan will be activated**. You can now use the advanced features of Tolgee!
53+
54+
![Self-hosted instance – activated plan](/img/docs/platform/subscription_self-hosted_plan.webp)
55+
56+
## Cancelling a plan
57+
58+
If you want to cancel your paid plan, you can do so on the Tolgee platform.
59+
Go to the [Subscription page of your organization](https://app.tolgee.io/billing-self-hosted) and click on the "Cancel" button **on the plan you want to cancel**.
60+
61+
![Cancel subscription](/img/docs/platform/subscription_self-hosted_cancel.webp)
62+
63+
You will be **prompted to confirm the cancellation**. Next, click on the "Confirm" button. After that, the plan will be canceled, and the **change will be applied to your self-hosted instance**.
64+
65+
![Confirm cancellation](/img/docs/platform/subscription_self-hosted_cancel_confirm.webp)

0 commit comments

Comments
 (0)