logos-storage/logos-storage-docs
1
0
Fork 0
mirror of https://github.com/logos-storage/logos-storage-docs.git synced 2026-01-05 23:03:07 +00:00
Code Issues Packages Projects Releases Wiki Activity

Update Quick Start guide for Windows (#52)

Browse Source
This commit is contained in:
Slava 2024-11-08 20:27:36 +02:00 committed by GitHub
parent 283337e0a2
commit e2c02ec2b6
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
1 changed files with 34 additions and 50 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

84
learn/quick-start.md
View File

@ -34,24 +34,14 @@ Please follow the steps for your OS from the list:
### Windows ### Windows
1. Download binary and checksum for your platform/architecture 1. Install latest Codex release
> [!WARNING] ```batch
> For Windows, only amd64 architecture is supported now. curl -sO https://get.codex.storage/install.cmd && install.cmd
```
> [!WARNING] > [!WARNING]
> Windows antivirus software and built-in firewalls may cause steps to fail. We will cover some possible errors here, but always consider checking your setup if requests fail - in particular, if temporarily disabling your antivirus fixes it, then it is likely to be the culprit. > Windows antivirus software and built-in firewalls may cause steps to fail. We will cover some possible errors here, but always consider checking your setup if requests fail - in particular, if temporarily disabling your antivirus fixes it, then it is likely to be the culprit.
```batch
set platform=windows
if %PROCESSOR_ARCHITECTURE%==AMD64 (set architecture=amd64) else (set architecture=arm64)
:: Binary
curl -LO https://github.com/codex-storage/nim-codex/releases/download/%version%/codex-%version%-%platform%-%architecture%-libs.zip
:: Checksum
curl -LO https://github.com/codex-storage/nim-codex/releases/download/%version%/codex-%version%-%platform%-%architecture%-libs.zip.sha256
```
If you see an error like: If you see an error like:
```batch ```batch
@ -64,46 +54,22 @@ Please follow the steps for your OS from the list:
curl -LO --ssl-no-revoke https://... curl -LO --ssl-no-revoke https://...
``` ```
2. Verify checksum 2. Update path using console output
```batch - Current session only
for /f "delims=" %a in ('certUtil -hashfile codex-%version%-%platform%-%architecture%-libs.zip SHA256 ^| findstr -vrc:"[^0123-9aAb-Cd-EfF ]"') do @set ACTUAL_HASH=%a ```batch
for /f "tokens=1" %a in (codex-%version%-%platform%-%architecture%-libs.zip.sha256) do set EXPECTED_HASH=%a :: Default installation directory
if %ACTUAL_HASH% == %EXPECTED_HASH% (echo. && echo codex-%version%-%platform%-%architecture%-libs.zip: OK) else (echo. && echo codex-%version%-%platform%-%architecture%-libs.zip: FAILED) set "PATH=%PATH%%LOCALAPPDATA%\Codex;"
``` ```
Make sure you get `OK` in the result - Update PATH permanently
``` - Control Panel --> System --> Advanced System settings --> Environment Variables
codex-v0.1.8-windows-amd64-libs.zip: OK - Alternatively, type `environment variables` into the Windows Search box
```
3. Extract binary and libraries 3. Check the result
```batch
if not exist %LOCALAPPDATA%\Codex mkdir %LOCALAPPDATA%\Codex
tar -xvf codex-%version%-%platform%-%architecture%-libs.zip -C %LOCALAPPDATA%\Codex
4. Rename binary and update user `path` variable
```batch
:: Rename binary
move /Y %LOCALAPPDATA%\Codex\codex-%version%-%platform%-%architecture%.exe %LOCALAPPDATA%\Codex\codex.exe
:: Add folder to the path permanently
setx PATH "%PATH%%LOCALAPPDATA%\Codex;"
:: Add folder to the path for the current session
PATH "%PATH%%LOCALAPPDATA%\Codex;"
```
4. Check the result
```shell ```shell
codex --version codex --version
``` ```
5. Cleanup
```batch
del codex-%version%-%platform%-%architecture%-libs.zip ^
codex-%version%-%platform%-%architecture%-libs.zip.sha256
```
## Run Codex ## Run Codex
We may [run Codex in different modes](/learn/run#run), and for a quick start we will run [Codex node](/learn/run#codex-node), to be able to share files in the network. We may [run Codex in different modes](/learn/run#run), and for a quick start we will run [Codex node](/learn/run#codex-node), to be able to share files in the network.
@ -125,12 +91,30 @@ We may [run Codex in different modes](/learn/run#run), and for a quick start we
> [!WARNING] > [!WARNING]
> Windows might at this stage prompt you to grant internet access to Codex. You must allow it for things to work. > Windows might at this stage prompt you to grant internet access to Codex. You must allow it for things to work.
> It also might be required to add incoming firewall rules for Codex and we can use `netsh` utility.
<details>
<summary>add firewall rules using netsh</summary>
```batch
:: Add rules
netsh advfirewall firewall add rule name="Allow Codex (TCP-In)" protocol=TCP dir=in localport=8070 action=allow
netsh advfirewall firewall add rule name="Allow Codex (UDP-In)" protocol=UDP dir=in localport=8090 action=allow
:: List rules
netsh advfirewall firewall show rule name=all | find /I "Codex"
:: Delete rules
netsh advfirewall firewall delete rule name="Allow Codex (TCP-In)"
netsh advfirewall firewall delete rule name="Allow Codex (UDP-In)"
```
</details>
```batch ```batch
:: Get Public IP :: Get Public IP
for /f "delims=" %a in ('curl -s --ssl-reqd ip.codex.storage') do @set nat=%a for /f "delims=" %a in ('curl -s --ssl-reqd ip.codex.storage') do set nat=%a
:: Run :: Run Codex
codex ^ codex ^
--data-dir=datadir ^ --data-dir=datadir ^
--disc-port=8090 ^ --disc-port=8090 ^