Skip to content

Commit 1875486

Browse files
authored
docs: add FAQ entry about 500 error page when opening workflow edito (#624)
## 📝 Description Add FAQ notice on v1.4 CE and EE about a problem that happens when opening the workflow editor the first time See #620 for error details ## ✅ Checklist - [X] I have tested this change - [ ] This change requires documentation update
1 parent 8eed90b commit 1875486

File tree

2 files changed

+30
-12
lines changed
  • docs/versioned_docs
    • version-CE/getting-started
    • version-EE/getting-started

2 files changed

+30
-12
lines changed

docs/versioned_docs/version-CE/getting-started/faq.md

Lines changed: 15 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -4,12 +4,6 @@ description: Frequently Asked Questions
44

55
# FAQ
66

7-
8-
9-
10-
11-
12-
137
This page contains Frequently Asked Questions.
148

159
## Architecture
@@ -256,6 +250,21 @@ Some commands like `bash -e` or `set -x otrace` may override this behavior and m
256250
257251
## Project
258252
253+
### When I try to edit the workflow, I get a 500 error page (workflow editor button)?
254+
255+
This can happen if no [initialization machine](../using-semaphore/pipelines#init-job) is defined. To fix the error, follow these steps:
256+
257+
1. Open the server menu and press **Settings**
258+
2. Select **Initialiation jobs** on the left menu
259+
3. Unsure at least **Environment type** and **Machine type** are select
260+
4. Press **Save changes** *even it the correct options were already selected*
261+
262+
:::note
263+
264+
Even if the correct options are selected, press **Save changes** to ensure they are applied.
265+
266+
:::
267+
259268
### Can I transfer ownership of a project?
260269
261270
Yes. The following conditions need to be met:

docs/versioned_docs/version-EE/getting-started/faq.md

Lines changed: 15 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -4,12 +4,6 @@ description: Frequently Asked Questions (EE)
44

55
# FAQ
66

7-
8-
9-
10-
11-
12-
137
This page contains Frequently Asked Questions.
148

159
## Architecture
@@ -256,6 +250,21 @@ Some commands like `bash -e` or `set -x otrace` may override this behavior and m
256250
257251
## Project
258252
253+
### When I try to edit the workflow, I get a 500 error page (workflow editor button)?
254+
255+
This can happen if no [initialization machine](../using-semaphore/pipelines#init-job) is defined. To fix the error, follow these steps:
256+
257+
1. Open the server menu and press **Settings**
258+
2. Select **Initialiation jobs** on the left menu
259+
3. Unsure at least **Environment type** and **Machine type** are select
260+
4. Press **Save changes** *even it the correct options were already selected*
261+
262+
:::note
263+
264+
Even if the correct options are selected, press **Save changes** to ensure they are applied.
265+
266+
:::
267+
259268
### Can I transfer ownership of a project?
260269
261270
Yes. The following conditions need to be met:

0 commit comments

Comments
 (0)