There are issues running Neon on macOS as described in the README.

[william-lbn]

(base) williamlee@MacBook-Pro-2 neon % cargo neon init
    Finished `dev` profile [unoptimized + debuginfo] target(s) in 0.88s
     Running `target/debug/neon_local init`
Initializing pageserver node 1 at '127.0.0.1:64000' in "/Users/williamlee/github/neon/.neon/pageserver_1"
Initializing object storage in "/Users/williamlee/github/neon/.neon/endpoint_storage"
(base) williamlee@MacBook-Pro-2 neon % 
(base) williamlee@MacBook-Pro-2 neon % 
(base) williamlee@MacBook-Pro-2 neon % cargo neon start
    Finished `dev` profile [unoptimized + debuginfo] target(s) in 0.83s
     Running `target/debug/neon_local start`
Starting neon broker at http://127.0.0.1:50051/Starting pageserver node 1 at '127.0.0.1:64000' in "/Users/williamlee/github/neon/.neon/pageserver_1", retrying for 10sStarting safekeeper at '127.0.0.1:5454' in '/Users/williamlee/github/neon/.neon/safekeepers/sk1', retrying for 10sStarting endpoint_storage at 127.0.0.1:9993
...
endpoint_storage started and passed status check, pid: 83342
pg_ctl: directory "/Users/williamlee/github/neon/.neon/storage_controller_db" does not exist
The files belonging to this database system will be owned by user "williamlee".
This user must also own the server process.

The database cluster will be initialized with locale "zh_CN.UTF-8".
The default database encoding has accordingly been set to "UTF8".
initdb: could not find suitable text search configuration for locale "zh_CN.UTF-8"
The default text search configuration will be set to "simple".

Data page checksums are disabled.

creating directory /Users/williamlee/github/neon/.neon/storage_controller_db ... ok
creating subdirectories ... ok
selecting dynamic shared memory implementation ... posix
selecting default max_connections ... 100
selecting default shared_buffers ... 
storage_broker started and passed status check, pid: 83335
128MB
selecting default time zone ... 
safekeeper-1 started and passed status check, pid: 83341
Asia/Shanghai
creating configuration files ... ok
running bootstrap script ... ok
performing post-bootstrap initialization ... ok

Sync to disk skipped.
The data directory might become corrupt if the operating system crashes.

initdb: warning: enabling "trust" authentication for local connections
initdb: hint: You can change this by editing pg_hba.conf or using the option -A, or --auth-local and --auth-host, the next time you run initdb.
Starting storage controller database...
waiting for server to start.... done
server started
localhost:1235 - accepting connections
Starting storage controller
..
pageserver started and passed status check, pid: 83340

storage_controller started and passed status check, pid: 83413

Running neon status check

Neon status check has not passed yet, continuing to wait

Neon started and passed status check
(base) williamlee@MacBook-Pro-2 neon % cargo neon tenant create --set-default
    Finished `dev` profile [unoptimized + debuginfo] target(s) in 0.90s
     Running `target/debug/neon_local tenant create --set-default`
tenant c7b30ef8bc510f69958766e3d1b732cd successfully created on the pageserver
Created an initial timeline '425eeb44330baa13a16af3ed614bdca1' for tenant: c7b30ef8bc510f69958766e3d1b732cd
Setting tenant c7b30ef8bc510f69958766e3d1b732cd as a default one
(base) williamlee@MacBook-Pro-2 neon % 
(base) williamlee@MacBook-Pro-2 neon % argo neon endpoint create main
zsh: command not found: argo
(base) williamlee@MacBook-Pro-2 neon % cargo neon endpoint create main
    Finished `dev` profile [unoptimized + debuginfo] target(s) in 0.81s
     Running `target/debug/neon_local endpoint create main`
(base) williamlee@MacBook-Pro-2 neon % 
(base) williamlee@MacBook-Pro-2 neon % cargo neon endpoint start main
    Finished `dev` profile [unoptimized + debuginfo] target(s) in 0.72s
     Running `target/debug/neon_local endpoint start main`
Starting existing endpoint main...
Starting postgres node at 'postgresql://cloud_admin@127.0.0.1:55432/postgres'
(base) williamlee@MacBook-Pro-2 neon % 
(base) williamlee@MacBook-Pro-2 neon % cargo neon endpoint list
    Finished `dev` profile [unoptimized + debuginfo] target(s) in 1.11s
     Running `target/debug/neon_local endpoint list`
 ENDPOINT  ADDRESS          TIMELINE                          BRANCH NAME  LSN  STATUS  
 main      127.0.0.1:55432  425eeb44330baa13a16af3ed614bdca1  main         ---  running 
(base) williamlee@MacBook-Pro-2 neon % 
(base) williamlee@MacBook-Pro-2 neon % 
(base) williamlee@MacBook-Pro-2 neon % psql -p 55432 -h 127.0.0.1 -U cloud_admin postgres
psql (17.5)
Type "help" for help.

postgres=# 
postgres=# CREATE TABLE t(key int primary key, value text);
CREATE TABLE
postgres=# insert into t values(1,1);
INSERT 0 1
postgres=# select * from t;
 key | value 
-----+-------
   1 | 1
(1 row)

postgres=# exit
(base) williamlee@MacBook-Pro-2 neon % 
(base) williamlee@MacBook-Pro-2 neon % 
(base) williamlee@MacBook-Pro-2 neon % 
(base) williamlee@MacBook-Pro-2 neon % cargo neon timeline branch --branch-name migration_check
    Finished `dev` profile [unoptimized + debuginfo] target(s) in 1.13s
     Running `target/debug/neon_local timeline branch --branch-name migration_check`
Created timeline '1206aa7d51e43176bc7a34c331dd22b5' at Lsn 0/154EBD8 for tenant: c7b30ef8bc510f69958766e3d1b732cd. Ancestor timeline: 'main'
(base) williamlee@MacBook-Pro-2 neon % 
(base) williamlee@MacBook-Pro-2 neon % 
(base) williamlee@MacBook-Pro-2 neon % cargo neon timeline list
    Finished `dev` profile [unoptimized + debuginfo] target(s) in 1.03s
     Running `target/debug/neon_local timeline list`
main [425eeb44330baa13a16af3ed614bdca1]
┗━ @0/154EBD8: migration_check [1206aa7d51e43176bc7a34c331dd22b5]
(base) williamlee@MacBook-Pro-2 neon % 
(base) williamlee@MacBook-Pro-2 neon % cargo neon endpoint create migration_check --branch-name migration_check
    Finished `dev` profile [unoptimized + debuginfo] target(s) in 1.02s
     Running `target/debug/neon_local endpoint create migration_check --branch-name migration_check`
(base) williamlee@MacBook-Pro-2 neon % 
(base) williamlee@MacBook-Pro-2 neon % 
(base) williamlee@MacBook-Pro-2 neon % 
(base) williamlee@MacBook-Pro-2 neon % cargo neon endpoint start migration_check
    Finished `dev` profile [unoptimized + debuginfo] target(s) in 1.12s
     Running `target/debug/neon_local endpoint start migration_check`
command failed: attempting to create a duplicate primary endpoint on tenant c7b30ef8bc510f69958766e3d1b732cd, timeline 1206aa7d51e43176bc7a34c331dd22b5: endpoint "migration_check" exists already. please don't do this, it is not supported.
(base) williamlee@MacBook-Pro-2 neon % 
(base) williamlee@MacBook-Pro-2 neon % 
(base) williamlee@MacBook-Pro-2 neon % cargo neon endpoint list
    Finished `dev` profile [unoptimized + debuginfo] target(s) in 1.08s
     Running `target/debug/neon_local endpoint list`
 ENDPOINT         ADDRESS          TIMELINE                          BRANCH NAME      LSN  STATUS              
 main             127.0.0.1:55432  425eeb44330baa13a16af3ed614bdca1  main             ---  running             
 migration_check  127.0.0.1:55434  1206aa7d51e43176bc7a34c331dd22b5  migration_check  ---  running, no pidfile 
(base) williamlee@MacBook-Pro-2 neon % 
(base) williamlee@MacBook-Pro-2 neon % 
(base) williamlee@MacBook-Pro-2 neon % 
(base) williamlee@MacBook-Pro-2 neon % psql -p 55434 -h 127.0.0.1 -U cloud_admin postgres
psql: error: connection to server at "127.0.0.1", port 55434 failed: received invalid response to SSL negotiation: H
(base) williamlee@MacBook-Pro-2 neon % 

cargo neon endpoint start migration_check Cannot be executed correctly.

psql -p 55434 -h 127.0.0.1 -U cloud_admin postgres Cannot be executed correctly.

I'm not sure if it's due to the version issue. When executing cargo neon endpoint list, the LSN shows as ---, but it was correct when created.