Skip to content

Server upgrade: Add note about change of port in nginx in 2025.2.x CE #808

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
MarcelGeo wants to merge 1 commit into
base: main
Choose a base branch
from
Open

Server upgrade: Add note about change of port in nginx in 2025.2.x CE #808

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
28 changes: 14 additions & 14 deletions src/server/upgrade/index.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -24,7 +24,7 @@ Perform the migration:
```bash
$ docker compose -f docker-compose.yml down # or similarly, based on your previous deployment
```
2. Clone or pull the <GitHubRepo id="MerginMaps/server/blob/master/" desc="server repository" /> or download <GitHubRepo id="MerginMaps/server/blob/master/deployment" desc="deployment folder" /> and open `/enterprise` folder.
2. Clone or pull the <GitHubRepo id="MerginMaps/server/blob/2025.7.3-ee/" desc="server repository" /> or download <GitHubRepo id="MerginMaps/server/blob/2025.7.3-ee/deployment" desc="deployment folder" /> and open `/enterprise` folder.
```bash
$ cd server/deployment/enterprise
```
Expand Down Expand Up @@ -87,7 +87,7 @@ Perform the migration:
```bash
$ docker compose -f docker-compose.yml down # or similarly, based on your previous deployment
```
2. Clone or pull the <GitHubRepo id="MerginMaps/server/blob/master/" desc="server repository" /> or download <GitHubRepo id="MerginMaps/server/blob/master/deployment" desc="deployment folder" /> and open `/community` folder.
2. Clone or pull the <GitHubRepo id="MerginMaps/server/blob/2025.7.3/" desc="server repository" /> or download <GitHubRepo id="MerginMaps/server/blob/2025.7.3/deployment" desc="deployment folder" /> and open `/community` folder.
```bash
$ cd server/deployment/community
```
Expand Down Expand Up @@ -132,7 +132,7 @@ Perform the migration:
```bash
$ docker compose -f docker-compose.yml down # or similarly, based on your previous deployment
```
2. Please clone or pull the <GitHubRepo id="MerginMaps/server/blob/master/" desc="server repository" /> or download <GitHubRepo id="MerginMaps/server/blob/master/deployment" desc="deployment folder" />
2. Please clone or pull the <GitHubRepo id="MerginMaps/server/blob/2025.5.1/" desc="server repository" /> or download <GitHubRepo id="MerginMaps/server/blob/2025.5.1/deployment" desc="deployment folder" />
```bash
$ cd server/deployment/enterprise
```
Expand Down Expand Up @@ -183,15 +183,15 @@ To enable Single Sign-On for your server, follow the instructions in [Deployment
Release 2025.3.x brings some changes on <MainPlatformName /> docker compose orchestration deployment procedure.
:::

Get the latest <GitHubRepo id="MerginMaps/server/blob/master/deployment/enterprise/docker-compose.yml" desc="docker-compose file" /> or update docker images manually to version `2025.3.0`.
Get the latest <GitHubRepo id="MerginMaps/server/blob/2025.3.2/deployment/enterprise/docker-compose.yml" desc="docker-compose file" /> or update docker images manually to version `2025.3.0`.
Perform the migration:

1. Stop your running docker containers
```bash
$ docker compose -f docker-compose.yml down # or similarly, based on your previous deployment
# INFO: After shutdown update the docker-compose.yml file to latest release
```
2. Please clone the <GitHubRepo id="MerginMaps/server/blob/master/" desc="server repository" /> or download <GitHubRepo id="MerginMaps/server/blob/master/deployment/" desc="deployment folder" />
2. Please clone the <GitHubRepo id="MerginMaps/server/blob/2025.3.2/" desc="server repository" /> or download <GitHubRepo id="MerginMaps/server/blob/2025.3.2/deployment/" desc="deployment folder" />
```bash
$ cd server/deployment/enterprise
```
Expand Down Expand Up @@ -225,19 +225,19 @@ Perform the migration:
$ docker exec merginmaps-server flask db upgrade enterprise@819e6b20ee93
```

<br>

## From 2024.2.x to 2025.2.x (CE) {#migration-guide-from-2024-2-x-to-2025-2-x-ce}

::: tip Before you upgrade!
Release 2025.2.x brings significant changes on <MainPlatformName /> docker compose orchestration infrastructure.

Previous individual `server` container is replaced by 3 service dedicated containers that split the core components of <MainPlatformName />, `server-gunicorn` the app, `celery-beat` Celery task scheduler and `celery-worker` a dedicated worker container for Celery tasks.

The proxy container now uses a new nginx image, and its default port has changed to 8080.
:::

<MigrationType type="CE" />

Get the latest <GitHubRepo id="MerginMaps/server/blob/master/deployment/community/docker-compose.yml" desc="docker-compose file" /> or update docker images manually to version `2025.2.2`.
Get the latest <GitHubRepo id="MerginMaps/server/blob/2025.2.3/docker-compose.yml" desc="docker-compose file" /> or update docker images manually to version `2025.2.2`.
Perform the migration:

1. Stop your running docker containers
Expand All @@ -246,7 +246,7 @@ Perform the migration:
# INFO: After shutdown update the docker-compose.yml file to latest release
```

2. Double check if below environment variables are available and filled in `.prod.env` environment file. If not, add them.
2. Double check if below environment variables are available and filled in `.prod.env` environment file. If not, add them.
```bash
SECURITY_EMAIL_SALT='<YOUR STRONG HASH>'
SECURITY_BEARER_SALT='<YOUR STRONG HASH>'
Expand Down Expand Up @@ -295,7 +295,7 @@ Previous individual `server` container is replaced by 3 service dedicated contai

<MigrationType type="EE" />

Get the latest <GitHubRepo id="MerginMaps/server/blob/master/deployment/enterprise/docker-compose.yml" desc="docker-compose file" /> or update docker images manually to version `2025.2.0`.
Get the <GitHubRepo id="MerginMaps/server/blob/2025.2.3/docker-compose.yml" desc="docker-compose file" /> or update docker images manually to version `2025.2.0`.
Perform the migration:

1. Stop your running docker containers and build the new images
Expand Down Expand Up @@ -347,7 +347,7 @@ Perform the migration:

## From 2024.3.x to 2024.4.x {#migration-guide-from-2024-3-x-to-2024-4-x}

Get the latest <GitHubRepo id="MerginMaps/server/blob/master/deployment/enterprise/docker-compose.yml" desc="docker-compose file" /> or update docker images manually to version `2024.4.0`.
Update docker images in `docker-compose.yml` to version `2024.4.0`.
Perform the migration:

<MigrationType type="EE" />
Expand Down Expand Up @@ -379,7 +379,7 @@ Perform the migration:

## From 2024.2.x to 2024.3.x {#migration-guide-from-2024-2-x-to-2024-3-x}

Get the latest <GitHubRepo id="MerginMaps/server/blob/master/deployment/enterprise/docker-compose.yml" desc="docker-compose file" /> or update docker images manually to version `2024.3.0`.
Update docker images in `docker-compose.yml` to version `2024.3.0`.
Perform the migration:

<MigrationType type="EE" />
Expand Down Expand Up @@ -410,7 +410,7 @@ Perform the migration:

## From 2023.6.1 to 2024.2.x (CE) {#migration-guide-from-2023-6-1-to-2024-2-x-ce}

Get the latest <GitHubRepo id="MerginMaps/server/blob/master/deployment/community/docker-compose.yml" desc="docker-compose file" /> or update docker images manually.
Get the <GitHubRepo id="MerginMaps/server/blob/2024.2.2/docker-compose.yml" desc="docker-compose file" /> or update docker images manually.

<MigrationType type="CE" />
Update image to `2024.2.2` and perform the migration:
Expand Down Expand Up @@ -475,7 +475,7 @@ Update image to `2024.2.1` and perform the migration:

-----

Get the latest <GitHubRepo id="MerginMaps/server/blob/master/deployment/community/docker-compose.yml" desc="docker-compose file" /> or update docker images manually to version `2023.6.1`.
Get the latest <GitHubRepo id="MerginMaps/server/blob/2023.6.1/docker-compose.yml" desc="docker-compose file" /> or update docker images manually to version `2023.6.1`.
Perform the migration:

<MigrationType type="CE" />
Expand Down
Loading