ONLYOFFICE Docs

Deploy ONLYOFFICE Docs, an open source office suite that includes web-based viewers and collaborative editors for text documents, spreadsheets, and presentations, providing high compatibility with OOXML files (.docx, .xlsx, .pptx).

1. Deploy ONLYOFFICE Docs

Estimated deployment time: 15–25 minutes

Follow the deployment instructions from the Get started section to configure the app, deploy it, and verify software installation.

For information on the app-specific configurations, see the Configuration options section.

Base distribution and plan

Supported distribution: Ubuntu 22.04 LTS
Recommended plans: Use a 2GB Shared CPU Compute Instance or higher.

Configuration options

Configure the advanced options to deploy your instance (all are optional).

The table maps the Cloud Manager UI fields to their corresponding API/CLI keys (stackscript_data) required for automated deployments.

StackScript ID: 1102907

UI field	API/CLI key	Description
Enable JSON Web Token validation	`jwt_enabled`	When true (default), it enables the JSON Web Token validation.
JSON Web Token Secret Key	`jwt_secret`	The secret key to validate the JSON Web Token in the request to the ONLYOFFICE Docs. The default is a randomly generated value.
ONLYOFFICE Docs version	`docs_version`	The ONLYOFFICE Docs version. Check available versions on Docker Hub onlyoffice/documentserver. Defaults to latest.
Enable the SSL connection	`ssl_enabled`	When true, TLS/SSL certificates are generated automatically. Defaults to false.
Domain	`domain`	The domain name for which TLS/SSL certificates are generated, like `example.com`. If no value is entered, the Linode instance’s default rDNS value is used.
Subdomain	`subdomain`	The subdomain for which TLS/SSL certificates are generated, like `blog` for `blog.example.com`.
Email address	`lets_encrypt_mail`	Your email address to use for generating TLS/SSL certificates and related notifications.

Use API, CLI, or Terraform

In addition to deploying the app to a new Linode instance via Cloud Manager, you can also use the Linode API, CLI, or Terraform. When running the operation, you need to provide the StackScript ID, supported Linux distribution, and app-specific fields along with the standard Linode deployment configurations.

Note: Generate a personal access token to authenticate your API, CLI, or Terraform requests.

curl --location 'https://api.linode.com/v4/linode/instances' \
    --header 'Content-Type: application/json' \
    --header 'Accept: application/json' \
    --header 'Authorization: Bearer abc123def456hij789klm' \
    --data-raw '{
        "region": "us-east",
        "type": "g6-standard-2",
        "image": "linode/ubuntu22.04",
        "label": "my-onlyoffice-one-click-app",
        "root_pass": "@C0mpl3x#P@ssw0rd",
        "stackscript_id": 1102907,
        "stackscript_data": {
            "lets_encrypt_mail": "jsmith@example.com"
        }
    }'

linode-cli linodes create \
    --region us-east \
    --type g6-standard-2 \
    --label my-onlyoffice-one-click-app \
    --image linode/ubuntu22.04 \
    --root_pass @C0mpl3x#P@ssw0rd \
    --stackscript_id 1102907 \
    --stackscript_data '{"lets_encrypt_mail":"jsmith@example.com"}'

resource "linode_instance" "my-linode" {
    region         = "us-east"
    type           = "g6-standard-2"
    label          = "my-onlyoffice-one-click-app"
    image          = "linode/ubuntu22.04"
    root_pass      = "@C0mpl3x#P@ssw0rd"
    stackscript_id = 1102907
    stackscript_data = {
       "lets_encrypt_mail" = "jsmith@example.com"
    }
}

2. Access ONLYOFFICE Docs

Open your web browser and navigate to the custom domain you entered during deployment, your Linode instance’s rDNS domain such as 192-0-2-1.ip.linodeusercontent.com, or the IP address. See the Manage IP addresses on a Linode guide for information on viewing the rDNS value.
On the ONLYOFFICE Docs welcome page, you can find a command to retrieve a randomly generated JSON validation token and an example document management system to test the application.

Additional resources

For more information about the installed packages, see the official documentation.

📘
Note that we can't vouch for the accuracy or timeliness of externally hosted resources.