Bare-Metal

User Guide for Installing OpenCloud

Follow the steps below to install and configure OpenCloud on your system.
This example is on Linux Ubuntu 24.04 distribution!

Disclaimer

Bare-metal deployments are not officially supported by OpenCloud. They are great for quick evaluation but are undocumented and have a minimalist feature set. If you choose this setup, you are on your own. With great power comes great responsibility.

1. Install Git and clone the repository

Open a terminal.
Update your package list:
```
sudo apt update && apt upgrade
```
Install Git using the following command:
```
sudo apt install git
```

Clone the OpenCloud repository:

git clone https://github.com/opencloud-eu/opencloud.git

2. Install the required packages

Download and install Go by following the official guide: 🔗go.dev/doc/install
Install npm (Node Package Manager):
```
sudo apt install npm -y
```
Install corepack globally:
```
sudo npm install -g corepack
```
Enable pnpm using corepack:
```
corepack enable pnpm
```

3. Build process and OpenCloud initialization

Navigate to the OpenCloud directory:
```
cd opencloud
```
Run the build generate process:
```
make clean generate -C opencloud build
```
Initialize OpenCloud with insecure configuration and set an admin password:
```
./bin/opencloud init --insecure true --admin-password admin
```
Start the OpenCloud server:
```
./bin/opencloud server
```

https://cloud.opencloud.test
user: admin
password: admin

5. Conclusion

Your OpenCloud server is now running and ready to use 🚀

If you encounter any issues or errors, try finding a solution here:

Common Issues & Help

User Guide for Installing OpenCloud​

1. Install Git and clone the repository​

2. Install the required packages​

3. Build process and OpenCloud initialization​

4. Login​

5. Conclusion​

If you encounter any issues or errors, try finding a solution here:​