Skip to content

Commit fd4ebe6

Browse files
Update docs to .Net 10 and ND6 (#288)
1 parent 75f4812 commit fd4ebe6

File tree

11 files changed

+33
-33
lines changed

11 files changed

+33
-33
lines changed

docs/developer/vs.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ title: Visual Studio
77

88
## Visual studio on Windows host os
99

10-
Visual Studio 2019 community or newer is recommended. You need to have dotnet 5 installed. [Download .NET 5 here](https://dotnet.microsoft.com/download/dotnet/5.0) or check the minimal version of Visual Studio supported.
10+
Visual Studio 2019 community or newer is recommended. You need to have dotnet 10 installed. [Download .NET 10 here](https://dotnet.microsoft.com/download/dotnet/10.0) or check the minimal version of Visual Studio supported.
1111

1212
Fork and clone your net-daemon/netdaemon.
1313

docs/get_started.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -11,8 +11,8 @@ Here is what you will need to start developing apps to automate your home with N
1111
- We recommend using [git](https://git-scm.com/) as a way to version control your apps.
1212
- Create an access token to use for authorization. The long lived access token is created under your profile in the Home Assistant GUI. Make sure the user account for this access token has Administrator privileges in Home Assistant
1313
- Have a .NET development environment. You can edit .cs files in any tool, but using a development environment is recommended
14-
- [Visual Studio 2022](https://visualstudio.microsoft.com/vs/), [Visual Studio Code](https://code.visualstudio.com) or [JetBrains Rider](https://www.jetbrains.com/rider/)
15-
- [.NET 9 SDK](https://dotnet.microsoft.com/download/dotnet/9.0) installed (if running in a VS Code Dev Container, it is pre-installed)
14+
- [Visual Studio 2026](https://visualstudio.microsoft.com/vs/), [Visual Studio Code](https://code.visualstudio.com) or [JetBrains Rider](https://www.jetbrains.com/rider/)
15+
- [.NET 10 SDK](https://dotnet.microsoft.com/download/dotnet/10.0) installed (if running in a VS Code Dev Container, it is pre-installed)
1616
- [Docker](https://www.docker.com/) installed if you want to use a Dev Container in VS Code (recommended)
1717

1818
Now you have all you need to develop an app, lets just do that by moving to app development.

docs/user/app_model/moving_from_v3.md

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ id: app_model_moving_from_v3
33
title: Moving from NetDaemon version 3
44
---
55

6-
This documentation how to upgrade and move to current .NET 7 based NetDaemon runtime v3.x to .NET 9 based NetDaemon runtime 5. There are some breaking issues but should be quite straight forward upgrade your applications and runtime environment.
6+
This documentation how to upgrade and move to current .NET 7 based NetDaemon runtime v3.x to .NET 10 based NetDaemon runtime 6. There are some breaking issues but should be quite straight forward upgrade your applications and runtime environment.
77

88
### Nuget packages
99

@@ -19,21 +19,21 @@ We try to always keep NetDaemon up-to-date with the latest versions of .NET. Sin
1919

2020
:::
2121

22-
The following changes have to be executed in order to develop your apps for NetDaemon 5 and .NET 9.
22+
The following changes have to be executed in order to develop your apps for NetDaemon 6 and .NET 10.
2323

2424
## 1. Update nuget packages
2525

2626
In this release we decided to change naming of NetDaemon nuget packages. The names are basically the same but without the `JoySoftware`. The reason is we needed to make sure we got the ownership of the NetDaemon id on our nuget packages for security reasons.
2727

2828
1. In all .NET project files `*.csproj`, rename all nuget references that starts with `JoySoftware.NetDaemon` to `NetDaemon`. For users that uses the source deploy option you will have to add the`NetDaemon.AppModel.SourceDeployedApps` nuget package!
29-
2. Change the target framework to 9.0
30-
3. Update Microsoft .NET references in your C# files to the corresponding .NET 9 versions
29+
2. Change the target framework to 10.0
30+
3. Update Microsoft .NET references in your C# files to the corresponding .NET 10 versions
3131

3232
### 2. Update docker containers and add-ons
3333

34-
The docker container, change the name from `netdaemon3` to `netdaemon5`. All other settings are the same.
34+
The docker container, change the name from `netdaemon3` to `netdaemon6`. All other settings are the same.
3535

36-
If you are using the addon write down the current settings in your current 3.x based addon and install the version 5 version and update settings as needed. In version 4 the default path had changed from `config/netdaemon3` to `config/netdaemon5`.
36+
If you are using the addon write down the current settings in your current 3.x based addon and install the version 6 version and update settings as needed. In version 4 the default path had changed from `config/netdaemon3` to `config/netdaemon6`.
3737

3838
### 3. Update the code generator
3939

docs/user/index.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -3,12 +3,12 @@ id: index
33
title: NetDaemon
44
---
55

6-
NetDaemon provides the capability to write home automations for Home Assistant in C#. Current version of the NetDaemon runtime is 5 and use .NET 9 and C# 13.
6+
NetDaemon provides the capability to write home automations for Home Assistant in C#. Current version of the NetDaemon runtime is 6 and use .NET 10 and C# 14.
77

88
## About NetDaemon
99

10-
Runtime version 5 has NuGet version >= `24.47.0` and uses the Docker image `netdaemon/netdaemon5`.
11-
No additional features will be added to version 4.
10+
Runtime version 6 has NuGet version >= `24.47.0` and uses the Docker image `netdaemon/netdaemon6`.
11+
No additional features will be added to version 5.
1212

1313
## Migrating from version 3
1414
We are no longer supporting version 3 of the runtime.

docs/user/started/development_source_deploy.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -32,7 +32,7 @@ dotnet new nd-src-project
3232
### Source files and configurations
3333

3434
**Do not copy project files. Only copy the contents under the `apps` folder!**
35-
Copy the content from the `apps` folder to to `/config/netdaemon5` if you are using
35+
Copy the content from the `apps` folder to to `/config/netdaemon6` if you are using
3636
add-on (note that you might have changed the destination in add-on config),
3737
or the destination folder you chose in the other hosting options.
3838
**Do not copy project files. Only copy the contents under the `apps` folder!**

docs/user/started/development_tools.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -71,13 +71,13 @@ Supervisor -> Add-on Store -> Menu -> Repositories
7171
- apt-get update
7272
- apt-get install -y apt-transport-https
7373
- apt-get update
74-
- apt-get install -y dotnet-sdk-9.0
74+
- apt-get install -y dotnet-sdk-10.0
7575
- dotnet tool install -g NetDaemon.HassModel.CodeGen
7676
packages: []
7777
log_level: info
7878
config_path: /
7979
```
80-
--> The part in the `init_commands` will install .NET SDK 9.0 only in the
80+
--> The part in the `init_commands` will install .NET SDK 10.0 only in the
8181
Studio Code Server add-on (Docker Container)
8282
5. Now you can start the Studio Code Server add-on by going the
8383
add-on information tab and pressing `OPEN WEB UI`.

docs/user/started/get_started.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@ building NetDaemon apps.
1010

1111
## Prerequisites
1212

13-
- Dotnet 9 SDK
13+
- Dotnet 10 SDK
1414
- Development environment
1515
- A Home Assistant long lived authorization token
1616
- Git (optional)
@@ -123,7 +123,7 @@ Use `dotnet publish -c Release -o [your output directory]`
123123
Then, copy all contents from `[your_output_directory]` to the appropriate
124124
location on your Home Assistant host:
125125

126-
- If using the NetDaemon add-on: `/config/netdaemon5`
126+
- If using the NetDaemon add-on: `/config/netdaemon6`
127127
- If using another hosting option: Copy to your chosen destination folder
128128

129129
For more details on different deployment options, see the [Installation Documentation](user/started/installation.md)

docs/user/started/installation.md

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -13,13 +13,13 @@ You can deploy your NetDaemon apps in several ways:
1313
## Deploying NetDAemon using the Home Assistant add-on
1414

1515
Once added to Home Assistant,
16-
select one of the V5 versions.
16+
select one of the V6 versions.
1717

1818
1. Create a folder structure under your Home Assistant host configuration
1919
directory to store NetDaemon apps:
2020

2121
```text
22-
/config/netdaemon5
22+
/config/netdaemon6
2323
```
2424

2525
2. Add the NetDaemon repository to the Home Assistant add-on store:
@@ -43,7 +43,7 @@ dotnet publish -c Release -o [outputdir]
4343
```
4444

4545
Copy all files and folders **within** the `[outputdir]`
46-
to `/config/netdaemon5` on your Home Assistant host.
46+
to `/config/netdaemon6` on your Home Assistant host.
4747

4848
For more details how to make this step easier, see the tutorial
4949
[Publish NetDeamon apps with Powershell](user/tutorials/publish_script.md).
@@ -52,7 +52,7 @@ For more details how to make this step easier, see the tutorial
5252

5353
In the add-on configuration, set `Application assembly` setting
5454
to the path for your project's entry assembly (DLL),
55-
relative to `/config/netdaemon5` folder.
55+
relative to `/config/netdaemon6` folder.
5656
Optionally, specify a separate path for configurations.
5757

5858
This is an example of how the configuration should should look like,
@@ -82,25 +82,25 @@ to avoid potential breaking changes.
8282

8383
```bash
8484
docker run -d \
85-
--name netdaemon5 \
85+
--name netdaemon6 \
8686
--restart=always \
8787
-e HomeAssistant__Host=192.168.1.4 \
8888
-e HomeAssistant__Token="eyJhbGciOiJIUz..." \
8989
-e NetDaemon__ApplicationAssembly=NetDaemonApps.dll \
9090
-e Logging__LogLevel__Default=Information \
9191
-e TZ=Europe/Stockholm \
9292
-v ~/netdaemon_config:/data \
93-
netdaemon/netdaemon5
93+
netdaemon/netdaemon6
9494
```
9595

9696
### Example using docker-compose.yaml for
9797

9898
```yaml
9999
services:
100100
netdaemon:
101-
image: netdaemon/netdaemon5 # use netdaemon/netdaemon5:ver
101+
image: netdaemon/netdaemon6 # use netdaemon/netdaemon6:ver
102102
# for specific version
103-
container_name: netdaemon5
103+
container_name: netdaemon6
104104
restart: always
105105
environment:
106106
- HomeAssistant__Host=your_ip_or_hostname # use host.docker.internal if HA in container (see section below)

docs/user/tutorials/publish_script.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -35,7 +35,7 @@ The Home Assistant PowerShell Module uses the IP address of Home Assistant to st
3535
$settings = (Get-Content appsettings.json | ConvertFrom-Json)
3636
3737
#CHANGE ME
38-
$slug = 'c6a2317c_netdaemon5' # the slug can be found in the url of the browser when navigating to the NetDaemon addon
38+
$slug = 'c6a2317c_netdaemon6' # the slug can be found in the url of the browser when navigating to the NetDaemon addon
3939
4040
$version = $slug.Split('_')[-1] # adapt if you are not using the default foldername for the addon
4141
$json = '{"addon": "' + $slug + '"}'

docs/user/tutorials/webhost.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -136,7 +136,7 @@ how easy it is to inject the ND services and use the generated HA classes.
136136
```
137137

138138
Now let's deploy the whole thing.
139-
While it is perfectly fine to copy the binaries to `/config/netdaemon5` for a _normal_ NetDaemon project, it will fail for Blazor.
139+
While it is perfectly fine to copy the binaries to `/config/netdaemon6` for a _normal_ NetDaemon project, it will fail for Blazor.
140140
We need to Publish the WebSite in order to build the web artifacts in `wwwroot`.
141141

142142
![](/img/docs/tutorials/webhost_2_publish.png)

0 commit comments

Comments
 (0)