Questions about self-hosting a TW cloud server

[JloAu]

I wanted to host a TW cloud server on my computer and access it from another computer, but I didn't find how to.

Firstly, I set the server IP to my local IP address to try to access it from my local network: I don't get any error, but I can't connect the scratch project to the server (I set the same IP:port as the server in the URL), either on a computer on the local network or on the computer hosting the server...

I also tried with my external IP address (as a server IP) and by configuring port forwarding to the local IP address of the computer hosting the server: this time I get the following error:

Traceback (most recent call last):
  File "/mnt/0CB604AD0CB604AD/Téléchargements/Scratchattach.py", line 53, in <module>
    server = sa.init_cloud_server( server_ip, server_port, length_limit=None, allow_non_numeric=True, whitelisted_projects=None, allow_nonscratch_names=True, blocked_ips=[], sync_players=True, log_var_sets=False)
             ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/home/jloau/.venv/lib/python3.12/site-packages/scratchattach/eventhandlers/cloud_server.py", line 371, in init_cloud_server
    return TwCloudServer(
           ^^^^^^^^^^^^^^
  File "/home/jloau/.venv/lib/python3.12/site-packages/scratchattach/eventhandlers/cloud_server.py", line 202, in __init__
    SimpleWebSocketServer.__init__(self, hostname, port=port, websocketclass=websocketclass)
  File "/home/jloau/.venv/lib/python3.12/site-packages/SimpleWebSocketServer/SimpleWebSocketServer.py", line 622, in __init__
    self.serversocket.bind(hostInfo[0][4])
OSError: [Errno 99] Cannot assign requested address
Exception ignored in: <function BaseEventHandler.__del__ at 0x7df1baed3060>
Traceback (most recent call last):
  File "/home/jloau/.venv/lib/python3.12/site-packages/scratchattach/eventhandlers/_base.py", line 74, in __del__
    self.stop()
  File "/home/jloau/.venv/lib/python3.12/site-packages/scratchattach/eventhandlers/cloud_server.py", line 347, in stop
    BaseEventHandler.stop(self, wait_call_threads)
  File "/home/jloau/.venv/lib/python3.12/site-packages/scratchattach/eventhandlers/_base.py", line 82, in stop
    thread = self._thread
             ^^^^^^^^^^^^
AttributeError: 'TwCloudServer' object has no attribute '_thread'

So I guess I am doing something wrong... Does hosting a TW cloud server at home and access it from somewhere else possible?

Scratchattach version : 3.0.0b4
Tried OS : Windows 11, Linux Mint 22, Android 7.1.1 (using Pydroid)

[TheCommCraft]

Would you please provide your full code?

[JloAu]

Sure:

server_ip = 'XX.XX.XX.XX'
server_port = 35987

server = sa.init_cloud_server( server_ip, server_port, length_limit=None, allow_non_numeric=True, whitelisted_projects=None, allow_nonscratch_names=True, blocked_ips=[], sync_players=True, log_var_sets=False)
server.start()

[faretek1]

This could be wrong, but in some cases, setting the server_ip to 0.0.0.0 will have a special effect that disables a firewall (this was the case when I used gorilla/websockets). It is definitely possible to self-host a cloud server

Also is the other machine on your Local area network? Or are you trying to self host for machines outside of your LAN?

[TheCommCraft]

I think the server ip is supposed to decide what clients can connect to your server. To allow your client machine to connect, you would need to set the ip to the address od that machine or to 0.0.0.0 (which allows all ips).

[JloAu]

This could be wrong, but in some cases, setting the server_ip to 0.0.0.0 will have a special effect that disables a firewall (this was the case when I used gorilla/websockets). It is definitely possible to self-host a cloud server

I think the server ip is supposed to decide what clients can connect to your server. To allow your client machine to connect, you would need to set the ip to the address od that machine or to 0.0.0.0 (which allows all ips).

Okay, I'll try this in few days. So I set the server_ip to 0.0.0.0, and I put the external ip of my server in the TW url?

Also is the other machine on your Local area network? Or are you trying to self host for machines outside of your LAN?

At first the machines will be on my LAN (for my tests), but next I would self host for machines outside of my LAN

[TheCommCraft]

For inside your LAN, you should use the local ip in turbowarp. For outside your LAN, you should use the URI that your port forwarding service provides. The 0.0.0.0 is at least the case for sockets and I believe that the convention holds for websockets aswell.

[JloAu]

It doesn't work for both inside and outside my LAN...

[JloAu]

The only thing I've been able to do is:

• host a TW server on the machine that receives the port redirects
• connect other devices (both inside and outside the local network) to the TW server using the same Python program (on the server side, I can see connections and handshakes)
• When I stop the server, the Python scripts on the other devices crash (obviously) due to loss of connection
• Regardless of the device (including the one hosting the server), I cannot communicate with the server with the Turbowarp project...

[TheCommCraft]

The problem seems to be that scratchattach does not use a secure web socket

[Boss-1s]

I believe I'm having the same problem....
I can't connect to my custom websocket server with turbowarp over localhost and 127.0.0.x, only through opening a new terminal window on the same VSCode Codespace that is running the websocket script

[Boss-1s]

My code: Actual sa server code: ```py ... server = sa.init_cloud_server( '127.0.0.1', 8765, length_limit=65536, allow_non_numeric=False, # customize what cloud values are allowed whitelisted_projects=["1202780939","895107188"], allow_nonscratch_names=False, blocked_ips=[], sync_players=True, # when set to False, other players will no longer be notified about cloud updates (only the server will see and parse them) log_var_sets=True # when set to True, all var sets will be printed to the console (can be spammy) ) server.start() cloud = session.connect_tw_cloud("1202780939", purpose="cloud host for scratchattach and packaged project", contact="Boss_1s on scratch, https://scratch.mit.edu/users/boss_1s", cloud_host="ws://127.0.0.1:8765") ... ``` Test WS connect: ```py import asyncio import websockets async def fake_handshake(): uri = "ws://localhost:8765" async with websockets.connect(uri) as websocket: await websocket.send('{'+ '"method": "handshake",'+ '"project_id": "1202780939",'+ '"user": "Boss_1s"'+ '}') response = await websocket.recv() print(f"Received: {response}") asyncio.run(fake_handshake()) ``` The test code works and the handshake executes, but doesn't work on TurboWarp itself

…

On Tue, Jun 9, 2026, 10:02 Boss_1s ***@***.***> wrote: *Boss-1s* left a comment (TimMcCool/scratchattach#648) <#648 (comment)> I believe I'm having the same problem.... I can't connect to my custom websocket server with turbowarp over localhost and 127.0.0.x, only through opening a new terminal window on the same VSCode Codespace that is running the websocket script — Reply to this email directly, view it on GitHub <#648?email_source=notifications&email_token=AWYU36OBDJWYLYQ74V6NWCD47ARGVA5CNFSNUABFM5UWIORPF5TWS5BNNB2WEL2JONZXKZKDN5WW2ZLOOQXTINRWGEYDMMZQGQ3KM4TFMFZW63VNPFXXK4S7MFRXI2LWNF2HTJLFOZSW45FMMZXW65DFOJPWG3DJMNVQ#issuecomment-4661063046>, or unsubscribe <https://github.com/notifications/unsubscribe-auth/AWYU36J2UO2XNQOS7IMNXCT47ARGVAVCNFSM6AAAAACZ45HJ72VHI2DSMVQWIX3LMV43OSLTON2WKQ3PNVWWK3TUHM2DMNRRGA3DGMBUGY> . Triage notifications, keep track of coding agent tasks and review pull requests on the go with GitHub Mobile for iOS <https://github.com/notifications/mobile/ios/AWYU36KXMHCV4VVP7EK575D47ARGVA5CNFSNUABFM5UWIORPF5TWS5BNNB2WEL2JONZXKZKDN5WW2ZLOOQXTINRWGEYDMMZQGQ3KM4TFMFZW63VNPFXXK4S7MFRXI2LWNF2HTJLFOZSW45FKMZXW65DFOJPWS33T> and Android <https://github.com/notifications/mobile/android/AWYU36O67NAGSJHB3ANC7V347ARGVA5CNFSNUABFM5UWIORPF5TWS5BNNB2WEL2JONZXKZKDN5WW2ZLOOQXTINRWGEYDMMZQGQ3KM4TFMFZW63VNPFXXK4S7MFRXI2LWNF2HTJLFOZSW45FOMZXW65DFOJPWC3TEOJXWSZA>. Download it today! You are receiving this because you are subscribed to this thread.Message ID: ***@***.***>

[TheCommCraft]

You might need to use the address "0.0.0.0" in the server code

[JloAu]

Is this fixable or should I use the TW cloud servers instead?

[TheCommCraft]

Exactly what is your code and what url do you use for turbowarp? Maybe you are still doing something wrong because it is working for me.

[JloAu]

Sure, here is my python code:

import scratchattach as sa
from scratchattach.cloud.cloud import CustomCloud

# Init Server & Cloud Events

server_ip = 'my external ip'
server_port = 9080
project_id="1321224718"

server = sa.init_cloud_server("0.0.0.0", server_port, length_limit=65536, allow_non_numeric=True, whitelisted_projects=[project_id], allow_nonscratch_names=True, blocked_ips=[], sync_players=True, log_var_sets=False)
server.start()

cloud = CustomCloud(project_id=project_id, cloud_host=f"ws://{server_ip}:{server_port}", username = "JloAu", length_limit = None, allow_non_numeric = True, _session = None, header = None, cookie = None, origin = None, print_connect_messages = False)
cloud_events=cloud.events()

And here is the turbowarp link: https://turbowarp.org/1321224718?cloud_host=ws://[my external ip]:9080

I use scratchattach 3.0.0b4