> For the complete documentation index, see [llms.txt](https://oceanic-lab.gitbook.io/oceanic-lab-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://oceanic-lab.gitbook.io/oceanic-lab-docs/setup-guides/server-setups/setup-installation.md).

# Setup Installation

{% hint style="info" %}
This process will work for nearly all hosting providers. We recommend using a FTP client such as [WinSCP](https://winscp.net/eng/index.php) or [FileZilla](https://filezilla-project.org/) for easy installation.
{% endhint %}

{% hint style="danger" %}
Make sure your server is offline before following any of the steps. Failing to do so will lead to major corruption and an improper installation!
{% endhint %}

## 1. Install the Correct Server .jar File

It's crucial to install the correct server .jar file, failing to do so can lead to data corruption, issues with world saves and plugin incompatibilities. Refer to [Resource Versions](/oceanic-lab-docs/miscellaneous/resources-versions.md) to find the correct jar file you need for each setup.

You can either drag the .jar file into your main server directory, or if your hosting provider has a .jar installer, use that! This is what the directory you'll be uploading your .jar file will look like. Delete the existing .jar file if there is one, and make sure it is the same name!

<figure><img src="/files/QCREUTUYfqZ04U8b1C8R" alt=""><figcaption></figcaption></figure>

## 2. Start up your server

To make sure the .jar file has installed correctly, try starting up your server. If it starts as expected, type `/ver` into the console and make sure it matches the version needed in [Resource Versions](/oceanic-lab-docs/miscellaneous/resources-versions.md).&#x20;

{% hint style="warning" %}
Make sure to shut down your server again after completing this step!
{% endhint %}

## 3. Drag the setup .ZIP file into your main directory

Drag the .zip file you downloaded from wherever you bought the server setup from into the main directory (see above).&#x20;

## 4. Delete certain existing folders

To avoid corruption, delete the following folders in your main directory if they already exist:

* `/plugins`
* `/world`
* `server.properties`
* `spigot.yml`
* `bukkit.yml`

## 5. Unzip the .ZIP file in your main directory

You may want to use the File Manager from your host to unzip, as it will be easier! Here's what you should be looking for:

<figure><img src="/files/FQ4otoPx1VCwT0EBFRHe" alt=""><figcaption><p>Example of extracting a .zip file on a Pterydactol panel</p></figcaption></figure>

<figure><img src="/files/Vz5sfPq8c7u3Ehy79XuU" alt=""><figcaption><p>Example of extracting a .zip file on the Pebblehost panel</p></figcaption></figure>

## 6. Start up your server

After unzipping your download, start up your server! If it's all gone smoothly, you should have little to no errors in your console, and you will be able to join your server!

{% hint style="info" %}
On first startup, it may take longer than usual to load as it generates core server files.
{% endhint %}

{% hint style="warning" %}
Upon joining your server, you may see notifications from several plugins asking for updates. This is to be expected as we are unable to constantly update our setup to allow for the latest versions of plugins.

Simply download the newest version of these plugins and replace the .jar in your /plugins directory with the new one. Restart your server and you'll be good to go!
{% endhint %}

## 7. Grant yourself OP permissions

To unlock all commands for your account, type `/op (your username)` in console. This will grant you access to every command on the server. You can also grant yourself the Owner rank with `/lp user (your username) group set Owner`

## 8. Customise your setup

In this documentation you'll find everything you need to know on how to make your setup truly yours. Check out [More Information](/oceanic-lab-docs/setup-guides/server-setups/more-information.md) now for your next steps!

{% hint style="info" %}
If you have any issues with installation, please reach out to us on our [Discord Server](<https://discord.gg/BsDmDAQ42B >)!
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://oceanic-lab.gitbook.io/oceanic-lab-docs/setup-guides/server-setups/setup-installation.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
