Skip to content

Commit 3a2d775

Browse files
authored
Updates based on recent run-through. (#109)
* Update based on recent run-through. Updated .net rewuirement, formatting and describing workaround/solution for #84 * Linux users are first class citizens. Vfkit is perhaps not needed after Podman 5.0.0, so splitting this to a separate segment.
1 parent 9646e12 commit 3a2d775

File tree

1 file changed

+18
-4
lines changed

1 file changed

+18
-4
lines changed

README.md

Lines changed: 18 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -18,15 +18,29 @@ These are some of the required steps, tips, and tricks when it comes to running
1818

1919
### Prerequisites
2020

21-
1. Newest [.NET 6 SDK](https://dotnet.microsoft.com/download/dotnet/6.0)
21+
1. .NET SDK matching your service (the latest App Template uses [.NET 8 SDK](https://dotnet.microsoft.com/download/dotnet/8.0), older versions may also require [.NET 6 SDK](https://dotnet.microsoft.com/download/dotnet/6.0))
2222
2. Newest [Git](https://git-scm.com/downloads)
2323
3. A code editor - we like [Visual Studio Code](https://code.visualstudio.com/Download)
2424
- Also
2525
install [recommended extensions](https://code.visualstudio.com/docs/editor/extension-gallery#_workspace-recommended-extensions) (
2626
f.ex. [C#](https://marketplace.visualstudio.com/items?itemName=ms-vscode.csharp))
27-
4. [Podman Desktop](https://podman-desktop.io)/[Podman](https://podman.io) (Linux users can also use native Docker) or [Docker Desktop](https://www.docker.com/products/docker-desktop) (Windows and Mac) This might require you to purchase a license.
28-
On mac with apple silicone (M1, M2, M3):
29-
5. [vfkit](https://github.com/crc-org/vfkit?tab=readme-ov-file#installation)
27+
4. Tooling to run containers:
28+
- [Podman](https://podman.io)* (optionally with [Podman Desktop](https://podman-desktop.io))
29+
- [Docker Desktop](https://www.docker.com/products/docker-desktop) (Windows and Mac) This might require you to purchase a license.
30+
- Linux/WSL users can also use native Docker.
31+
32+
> [!NOTE]
33+
> On Mac with Apple silicone (M-series CPU), [vfkit](https://github.com/crc-org/vfkit?tab=readme-ov-file#installation) might be needed - consult the install guide/requirements for your container toolkit
34+
35+
36+
> [!WARNING]
37+
> *Podman on Windows/WSL2 can be tricky. If faced with the same issue as described in https://github.com/Altinn/app-localtest/issues/84, please apply the following (tested on Podman 4.9.2 and 5.1.1):
38+
> * Install the Podman Machine with "user-mode networking" enabled (the setting for root/rootless seems not to have an impact)
39+
> * Apply local updates to `podman-compose.yml` and `src\appsettings.Podman.json` replacing `host.docker.internal` with `<your-hostname>.local` (obtained by running `hostname` in the windows host commandline).
40+
> e.g. in `src\appsettings.Podman.json` the config `"LocalAppUrl": "http://host.docker.internal:5005",` becomes `"LocalAppUrl": "http://AAD-123456789.local:5005",` if your hostname is `AAD-123456789`
41+
>
42+
> If you have special networking needs (VPN), additional settings might be needed in WSL2/Podman. Please consult their respective doc/forums. https://learn.microsoft.com/en-us/windows/wsl/wsl-config#wslconfig and https://github.com/containers/podman/blob/main/docs/tutorials/basic_networking.md are good starting-ponts.
43+
3044
### Setup
3145

3246
#### Clone the repository

0 commit comments

Comments
 (0)