{"id":2901,"date":"2024-05-15T05:35:29","date_gmt":"2023-05-01T00:02:30","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-ubuntu-22-04-lts","status":"publish","type":"post","link":"https:\/\/netcloud24.com\/knowledgebase\/how-to-install-mastodon-social-network-with-docker-on-ubuntu-22-04-lts\/","title":{"rendered":"Linux VPS & VPS Windows Setup Guide | NetCloud24 Mastodon Social Network with Docker on Ubuntu 22.04 LTS"},"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 for providing a federated platform where users control their own data. In this guide, we will walk you through the steps to install Mastodon on Ubuntu 22.04 LTS using Docker. Whether you’re deploying Mastodon locally or on a , these instructions will help you get your Mastodon instance running efficiently.<\/p>\n

\n

Step 1: Update Your System<\/h2>\n

Before starting the installation, it’s important to update your system to ensure that all packages are up to date. Run the following commands:<\/p>\n

sudo apt update && sudo apt upgrade<\/code><\/pre>\n
This will update all packages on your system, ensuring security and stability. This step is crucial whether you\u2019re working on a local machine or hosting your Mastodon instance on a UK Windows VPS<\/a>.<\/p>\n<\/section>\n
\n
Step 2: Install Docker and Docker Compose<\/h2>\n
Mastodon runs inside Docker containers, so you\u2019ll need to install Docker and Docker Compose on your system. First, install Docker using the following commands:<\/p>\n
\r\nsudo apt install apt-transport-https ca-certificates curl software-properties-common\r\ncurl -fsSL https:\/\/download.docker.com\/linux\/ubuntu\/gpg | sudo apt-key add -\r\nsudo add-apt-repository \"deb [arch=amd64] https:\/\/download.docker.com\/linux\/ubuntu $(lsb_release -cs) stable\"\r\nsudo apt update\r\nsudo apt install docker-ce docker-ce-cli containerd.io\r\n            <\/code><\/pre>\n
Once Docker is installed, install Docker Compose:<\/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
You can verify the installation by checking the version of Docker and Docker Compose:<\/p>\n
docker --version<\/code><\/pre>\n
docker-compose --version<\/code><\/pre>\n
This step prepares your system to run Mastodon using Docker containers, making it ideal for both local deployment and hosting on a Windows VPS hosting UK<\/a> platform.<\/p>\n<\/section>\n
\n
Step 3: Set Up Mastodon with Docker<\/h2>\n
Now that Docker is installed, you can download the Mastodon repository and set it up using Docker Compose. First, create a directory for Mastodon and clone the repository:<\/p>\n
\r\nmkdir ~\/mastodon\r\ncd ~\/mastodon\r\ngit clone https:\/\/github.com\/mastodon\/mastodon.git .\r\n            <\/code><\/pre>\n
Next, copy the example environment file:<\/p>\n
cp .env.production.sample .env.production<\/code><\/pre>\n
Open the .env.production<\/code> file and edit it to configure your Mastodon instance, including setting your domain name, email settings, and database passwords. For example:<\/p>\n
\r\n# Replace 'example.com' with your domain name\r\nLOCAL_DOMAIN=example.com\r\nSMTP_SERVER=smtp.mailgun.org\r\nSMTP_PORT=587\r\nSMTP_LOGIN=postmaster@example.com\r\nSMTP_PASSWORD=yourpassword\r\n            <\/code><\/pre>\n
This configuration will ensure that Mastodon works correctly in a production environment, whether you’re hosting it on your local server or a VPS Windows VPS Servers<\/a> setup.<\/p>\n<\/section>\n
\n
Step 4: Build and Start Mastodon with Docker<\/h2>\n
Now you are ready to build the Mastodon containers. Run the following commands to build and set up the Docker containers for Mastodon:<\/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, you can start the Mastodon instance:<\/p>\n
docker-compose up -d<\/code><\/pre>\n
Mastodon will now be running in the background using Docker containers. This setup is ideal for both local and cloud-based hosting environments, such as a Microsoft SQL VPS Windows<\/a>.<\/p>\n<\/section>\n
\n
Step 5: Set Up Nginx as a Reverse Proxy<\/h2>\n
To make your Mastodon instance accessible via the web, it’s recommended to use Nginx as a reverse proxy. Install Nginx by running:<\/p>\n
sudo apt install nginx<\/code><\/pre>\n
After installation, create an Nginx configuration file for Mastodon:<\/p>\n
sudo nano \/etc\/nginx\/sites-available\/mastodon<\/code><\/pre>\n
Add the following configuration, replacing example.com<\/code> with your domain:<\/p>\n
\r\nserver {\r\n    listen 80;\r\n    server_name example.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
Save the file, enable the site, and restart Nginx:<\/p>\n
\r\nsudo ln -s \/etc\/nginx\/sites-available\/mastodon \/etc\/nginx\/sites-enabled\/\r\nsudo systemctl restart nginx\r\n            <\/code><\/pre>\n
Nginx is now configured to proxy traffic to your Mastodon instance, making it accessible on the web. This step is important whether you’re hosting locally or on a Windows VPSVirtual Private Server hosting<\/a> platform.<\/p>\n<\/section>\n
\n
Step 6: Configure SSL with Let’s Encrypt<\/h2>\n
For security, you should enable SSL on your Mastodon instance. You can use Let\u2019s Encrypt to obtain a free SSL certificate. First, install Certbot:<\/p>\n
sudo apt install certbot python3-certbot-nginx<\/code><\/pre>\n
Next, run the Certbot command to automatically configure SSL for your Mastodon domain:<\/p>\n
sudo certbot --nginx -d example.com<\/code><\/pre>\n
Certbot will request and install the SSL certificate for your domain, ensuring secure HTTPS access to your Mastodon instance. This step is important whether you’re hosting on a local server or on a Windows VPS hosting UK<\/a>.<\/p>\n<\/section>\n
\n
Step 7: Access Your Mastodon Instance<\/h2>\n
Your Mastodon instance should now be running and accessible via your domain name. Open your browser and navigate to https:\/\/example.com<\/code> (replace with your domain) to access your Mastodon social network.<\/p>\n
You can create an admin account and start customizing your instance, whether you’re using a local setup or a UK VPS Windows<\/a> hosting solution.<\/p>\n<\/section>\n