Steps

1. Get the current version of Stalwart Mail.

   • current version: v0.8.0

2. Check the documentation for the latest version.

   • upgrading documentation: https://github.com/stalwartlabs/stalwart/blob/main/UPGRADING.md

3. Upgrade to the next major version incrementally

   • next major version: v0.9.x
   • next major version: v0.10.x
   • next major version: v0.11.x
   • next major version: v0.12.x

4. Fix issues that arise during the upgrade process.

   • issue: failed to start when using v0.11.0 root causes:

     • https://github.com/stalwartlabs/stalwart/issues/1057
     • https://github.com/stalwartlabs/stalwart/issues/1104

     resolution: use v0.11.3 when upgrading from v0.10 to v0.11

Steps

1. Get the current version of Stalwart Mail.

   • current version: v0.8.0

2. Check the documentation for the latest version.

   • upgrading documentation: https://github.com/stalwartlabs/stalwart/blob/main/UPGRADING.md

3. Upgrade to the next major version incrementally

   • next major version: v0.9.x
   • next major version: v0.10.x
   • next major version: v0.11.x
   • next major version: v0.12.x

4. Fix issues that arise during the upgrade process.

   • issue: failed to start when using v0.11.0 root causes:

     • https://github.com/stalwartlabs/stalwart/issues/1057
     • https://github.com/stalwartlabs/stalwart/issues/1104

     resolution: use v0.11.3 when upgrading from v0.10 to v0.11

Steps

1. Get the current version of Stalwart Mail.

   • current version: v0.8.0

2. Check the documentation for the latest version.

   • upgrading documentation: https://github.com/stalwartlabs/stalwart/blob/main/UPGRADING.md

3. Upgrade to the next major version incrementally

   • next major version: v0.9.x
   • next major version: v0.10.x
   • next major version: v0.11.x
   • next major version: v0.12.x

4. Fix issues that arise during the upgrade process.

   • issue: failed to start when using v0.11.0 root causes:

     • https://github.com/stalwartlabs/stalwart/issues/1057
     • https://github.com/stalwartlabs/stalwart/issues/1104

     resolution: use v0.11.3 when upgrading from v0.10 to v0.11

Hugo uses the excellent go html/template library for its template engine. It is an extremely lightweight engine that provides a very small amount of logic. In our experience that it is just the right amount of logic to be able to create a good static website. If you have used other template systems from different languages or frameworks you will find a lot of similarities in go templates.

This document is a brief primer on using go templates. The go docs provide more details.

Step 1. Install Hugo

Goto hugo releases and download the appropriate version for your os and architecture.

Save it somewhere specific as we will be using it in the next step.

More complete instructions are available at installing hugo

Step 2. Build the Docs

Hugo has its own example site which happens to also be the documentation site you are reading right now.

Follow the following steps:

1. Clone the hugo repository
2. Go into the repo
3. Run hugo in server mode and build the docs
4. Open your browser to http://localhost:1313

Corresponding pseudo commands:

Hugo uses the excellent go html/template library for its template engine. It is an extremely lightweight engine that provides a very small amount of logic. In our experience that it is just the right amount of logic to be able to create a good static website. If you have used other template systems from different languages or frameworks you will find a lot of similarities in go templates.

This document is a brief primer on using go templates. The go docs provide more details.

Step 1. Install Hugo

Goto hugo releases and download the appropriate version for your os and architecture.

Save it somewhere specific as we will be using it in the next step.

More complete instructions are available at installing hugo

Step 2. Build the Docs

Hugo has its own example site which happens to also be the documentation site you are reading right now.

Follow the following steps:

1. Clone the hugo repository
2. Go into the repo
3. Run hugo in server mode and build the docs
4. Open your browser to http://localhost:1313

Corresponding pseudo commands:

Hugo uses the excellent go html/template library for its template engine. It is an extremely lightweight engine that provides a very small amount of logic. In our experience that it is just the right amount of logic to be able to create a good static website. If you have used other template systems from different languages or frameworks you will find a lot of similarities in go templates.

This document is a brief primer on using go templates. The go docs provide more details.

Step 1. Install Hugo

Goto hugo releases and download the appropriate version for your os and architecture.

Save it somewhere specific as we will be using it in the next step.

More complete instructions are available at installing hugo

Step 2. Build the Docs

Hugo has its own example site which happens to also be the documentation site you are reading right now.

Follow the following steps:

1. Clone the hugo repository
2. Go into the repo
3. Run hugo in server mode and build the docs
4. Open your browser to http://localhost:1313

Corresponding pseudo commands:

Hugo uses the excellent go html/template library for its template engine. It is an extremely lightweight engine that provides a very small amount of logic. In our experience that it is just the right amount of logic to be able to create a good static website. If you have used other template systems from different languages or frameworks you will find a lot of similarities in go templates.

This document is a brief primer on using go templates. The go docs provide more details.

Hugo uses the excellent go html/template library for its template engine. It is an extremely lightweight engine that provides a very small amount of logic. In our experience that it is just the right amount of logic to be able to create a good static website. If you have used other template systems from different languages or frameworks you will find a lot of similarities in go templates.

This document is a brief primer on using go templates. The go docs provide more details.

Step 1. Install Hugo

Goto hugo releases and download the appropriate version for your os and architecture.

Save it somewhere specific as we will be using it in the next step.

More complete instructions are available at installing hugo

Step 2. Build the Docs

Hugo has its own example site which happens to also be the documentation site you are reading right now.

Follow the following steps:

1. Clone the hugo repository
2. Go into the repo
3. Run hugo in server mode and build the docs
4. Open your browser to http://localhost:1313

Corresponding pseudo commands: