{"id":2913,"date":"2025-01-19T13:28:30","date_gmt":"2022-05-13T14:52:42","guid":{"rendered":""},"modified":"2025-02-02T00:46:19","modified_gmt":"2025-02-01T23:46:19","slug":"how-to-install-mastodon-social-network-with-docker-on-rocky-linux-9","status":"publish","type":"post","link":"https:\/\/netcloud24.com\/knowledgebase\/how-to-install-mastodon-social-network-with-docker-on-rocky-linux-9\/","title":{"rendered":"Linux VPS & VPS Windows Setup Guide | NetCloud24 Mastodon Social Network with Docker on Rocky Linux 9"},"content":{"rendered":"

\u00a0<\/p>\n<\/p>\n

\n

\u00a0<\/h1>\n<\/header>\n
\n

Mastodon is an open-source, decentralized social network that has gained popularity as a federated platform, allowing users to manage their own communities. In this guide, we will walk you through the process of installing Mastodon using Docker on Rocky Linux 9. Whether you are setting up a local instance or deploying Mastodon on a , this tutorial will guide you through the necessary steps to get started.<\/p>\n

\n

Step 1: Install Docker and Docker Compose<\/h2>\n

Before installing Mastodon, you need to ensure Docker and Docker Compose are installed on your Rocky Linux 9 server. Run the following commands to install Docker:<\/p>\n

\r\nsudo dnf update -y\r\nsudo dnf install -y dnf-plugins-core\r\nsudo dnf config-manager --add-repo https:\/\/download.docker.com\/linux\/centos\/docker-ce.repo\r\nsudo dnf install -y docker-ce docker-ce-cli containerd.io\r\n            <\/code><\/pre>\n
Once Docker is installed, enable and start the Docker service:<\/p>\n
\r\nsudo systemctl enable docker\r\nsudo systemctl start docker\r\n            <\/code><\/pre>\n
Now install Docker Compose using the following command:<\/p>\n
\r\nsudo curl -L \"https:\/\/github.com\/docker\/compose\/releases\/download\/1.29.2\/docker-compose-$(uname -s)-$(uname -m)\" -o \/usr\/local\/bin\/docker-compose\r\nsudo chmod +x \/usr\/local\/bin\/docker-compose\r\n            <\/code><\/pre>\n
Verify the installation by checking the Docker and Docker Compose versions:<\/p>\n
\r\ndocker --version\r\ndocker-compose --version\r\n            <\/code><\/pre>\n
This setup prepares your server to run Docker containers, whether locally or on a VPS Windows VPS Servers<\/a> platform.<\/p>\n<\/section>\n
\n
Step 2: Set Up Mastodon Docker Environment<\/h2>\n
Create a directory for Mastodon and navigate into it:<\/p>\n
mkdir ~\/mastodon && cd ~\/mastodon<\/code><\/pre>\n
Clone the Mastodon repository from GitHub:<\/p>\n
git clone https:\/\/github.com\/mastodon\/mastodon.git .<\/code><\/pre>\n
Switch to the latest stable release branch:<\/p>\n
git checkout $(git tag | grep -v rc | tail -1)<\/code><\/pre>\n<\/section>\n
\n
Step 3: Configure Environment Variables<\/h2>\n
Copy the sample environment configuration file to use for your instance:<\/p>\n
cp .env.production.sample .env.production<\/code><\/pre>\n
Edit the .env.production<\/code> file to configure your domain, email, and database information. Make sure to set up your domain name, for example:<\/p>\n
\r\nLOCAL_DOMAIN=yourdomain.com\r\nSMTP_SERVER=smtp.yourmailprovider.com\r\nSMTP_PORT=587\r\nSMTP_LOGIN=yourlogin\r\nSMTP_PASSWORD=yourpassword\r\n            <\/code><\/pre>\n
Configure other necessary settings, including database passwords. This configuration ensures Mastodon will work correctly when deployed, whether locally or on a UK VPS Windows<\/a> hosting solution.<\/p>\n<\/section>\n
\n
Step 4: Build and Start Mastodon with Docker Compose<\/h2>\n
Now that the environment is set up, you can build and start the Mastodon containers. Run the following commands to build the containers:<\/p>\n
\r\ndocker-compose build\r\ndocker-compose run --rm web rake db:setup\r\ndocker-compose run --rm web rake db:migrate\r\ndocker-compose run --rm web rake assets:precompile\r\n            <\/code><\/pre>\n
Once the containers are built, start Mastodon:<\/p>\n
docker-compose up -d<\/code><\/pre>\n
Mastodon will now be running in the background using Docker. Whether you’re deploying locally or using a Windows VPSVirtual Private Server hosting<\/a> platform, your Mastodon instance will be accessible.<\/p>\n<\/section>\n
\n
Step 5: Configure Nginx as a Reverse Proxy<\/h2>\n
To make your Mastodon instance publicly accessible, you can configure Nginx as a reverse proxy. Install Nginx with the following command:<\/p>\n
sudo dnf install nginx<\/code><\/pre>\n
After installation, create a configuration file for Mastodon in Nginx:<\/p>\n
sudo nano \/etc\/nginx\/conf.d\/mastodon.conf<\/code><\/pre>\n
Add the following configuration, replacing yourdomain.com<\/code> with your domain:<\/p>\n
\r\nserver {\r\n    listen 80;\r\n    server_name yourdomain.com;\r\n    \r\n    location \/ {\r\n        proxy_pass http:\/\/127.0.0.1:3000;\r\n        proxy_set_header Host $host;\r\n        proxy_set_header X-Real-IP $remote_addr;\r\n        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;\r\n        proxy_set_header X-Forwarded-Proto $scheme;\r\n    }\r\n}\r\n            <\/code><\/pre>\n
Enable and restart Nginx:<\/p>\n
\r\nsudo systemctl enable nginx\r\nsudo systemctl restart nginx\r\n            <\/code><\/pre>\n
This will allow users to access your Mastodon instance through your domain, whether it’s hosted locally or on a VPS Windows VPShosting UK<\/a> platform.<\/p>\n<\/section>\n
\n
Step 6: Secure Your Mastodon Instance with SSL<\/h2>\n
For security, you should enable SSL on your Mastodon instance using Let\u2019s Encrypt. Install Certbot and its Nginx plugin:<\/p>\n
sudo dnf install certbot python3-certbot-nginx<\/code><\/pre>\n
Obtain the SSL certificate and configure Nginx with the following command:<\/p>\n
sudo certbot --nginx -d yourdomain.com<\/code><\/pre>\n
Certbot will automatically configure SSL for your domain, securing your Mastodon instance with HTTPS, whether hosted on a local server or a Windows VPS hosting UK<\/a>.<\/p>\n<\/section>\n